home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / WINDOWS / WINBATT.ARJ / WINBATT.TXT < prev    next >
Text File  |  1992-03-20  |  9KB  |  201 lines
  1.                                 WinBatt
  2.               Toshiba Battery Monitor for Windows 3.0/3.1
  3.                          Version 1.0, 3/20/92
  4.                      SHAREWARE Licensing in effect!
  5.  
  6.                   Copyright 1991,1992  F. Scott Porter
  7.  
  8. SHAREWARE:
  9. This program is shareware and is not in the public domain.  There are
  10. distribution requirements, and licensing rules.  This program required
  11. a substantial amount of my time to write and your support is required
  12. if upgrades and improvements are to be made.  If you find this program
  13. useful please send $20 to:
  14.  
  15.                            F. Scott Porter
  16.                            Porter Gable Associates
  17.                            143 Woodbine St.
  18.                            Providence, RI 02906
  19.  
  20. Also please read the licensing and distribution information at the end
  21. of this file.
  22.  
  23. INTRODUCTION:
  24. WinBatt was constructed in response to several shortcomings in the
  25. popup window interface to the special features of Toshiba laptop
  26. computers.  Notably that the popup window does not function while
  27. running Microsoft Windows 3.0/3.1 in '386 Enhanced mode.  In addition I
  28. found the popup window to be inconvenient in that I had to warp my hand
  29. around the Toshiba keyboard in order to view my battery status.  The
  30. result of these two complaints is the program included here.  Winbatt
  31. uses the same technique as the popup window to obtain the computer's
  32. battery status by querying the special hardware registers in the
  33. Toshiba power supply.  Winbatt, however, was designed from the ground
  34. up to be a native Windows 3.0/3.1 application and integrates completely
  35. into that Environment.  Winbatt can be left running continuously just
  36. like the Windows clock, updating the battery status once every second
  37. and a half, and it is completely compatible with all operating modes of
  38. Windows 3.0 and Windows 3.1.
  39.  
  40. Winbatt has been written to function with all models of Toshiba laptop
  41. and notebook computers that are capable of running Microsoft Windows
  42. including those with one or two battery modules.  Winbatt will
  43. automatically recognize the type of computer that it is running on and
  44. configures itself accordingly.
  45.  
  46. FEATURES:
  47. WinBatt contains the following features:
  48.  
  49. - Automatically recognizes which Toshiba computer it is running on.
  50. - Works with one and two battery systems.
  51. - Updates itself once per 1.5 seconds, with speed optimized display techniques.
  52. - Battery set function is through menus and easy to use dialog boxes.
  53. - Completely compatible with all modes of Windows 3.0/3.1
  54. - Accesses the Toshiba special hardware registers directly to obtain
  55.   battery information.
  56. - Battery status is reflected in the programs icon when the program is
  57.   minimized to the Windows desktop. (only on one battery systems)
  58. - WinBatt stores its position on the desktop in WinBatt.ini so that it
  59.   will always reappear at the last place you left it on the desktop.
  60. - Compatible with Windows 3.1.
  61.  
  62. In the future (hopefully soon) I will implement the following additions:
  63.  
  64. - Battery gauge graphic with sizing that appears like a car fuel gauge.
  65. - Dynamic icons for two battery systems.
  66.  
  67. INSTALLATION:
  68. You may install this program either by selecting "New" and then
  69. "Program Item" in the "File" menu of the program manager, or by running
  70. the Window's setup program in the "Main" program group.
  71.  
  72. INSTRUCTIONS:
  73. The program is virtually self explanatory.  If you want to view your
  74. battery status double click on the WinBatt program icon or run the
  75. program by selecting "Run"  in the "File" menu of the program manager. 
  76. If you want the program to run automatically every time you start
  77. Windows then you must edit the "win.ini" file in your main windows
  78. directory and add the full DOS path to the "load =" (for loading the
  79. program minimized) or "run="  (for running the program as a window). 
  80. For example:
  81.  
  82.     run = C:\BIN\WINPROGS\WinBatt.exe
  83.     or
  84.     load = C:\BIN\WINPROGS\WinBatt.exe
  85.  
  86. If you want to "load" or "run" multiple programs then you must put a
  87. space between program items.  In Windows 3.1 you simply drag the
  88. WinBatt icon to the "StartUp" group on your Program Manager desktop.
  89.  
  90. Once WinBatt is running the battery status of your computer will be
  91. displayed in one or two bar graphs depending on whether your system has
  92. one or two batteries.  If your battery is not installed then "N/A" will
  93. be displayed.  If your battery needs to be set, for example if you have
  94. just installed a fresh battery, then "???" will be displayed.  This
  95. behavior is identical to the Toshiba "popup window".  If you need to
  96. set the battery then you must select "Set Battery..." in the "Main"
  97. menu on single battery systems, and either the "Left Battery..." or
  98. "Right Battery" submenu items for dual battery systems.  A dialog box
  99. will be displayed and you may tab between the various items if your
  100. system does not have a mouse.  The "Full" control button is preselected
  101. so that if you are installing a fresh battery you can just hit the
  102. return key when the dialog box is displayed.  The bizarre percentage
  103. numbers displayed (14%, 28%, etc...) are just a result of how many
  104. discrete battery states the Toshiba hardware monitoring system
  105. supports.
  106.  
  107. You may leave WinBatt running continuously and the battery status will
  108. be updated once per 1.5 seconds or you can "minimize" the program to an
  109. icon and the battery status will be reflected in the icon(on one
  110. battery systems).  I have WinBatt preloaded on my system along with the
  111. Windows clock so that I always have visual access to these utilities.
  112.  
  113. WINDOWS ENHANCED MODE:
  114. The instructions for installing WinBatt under Windows 3.0/3.1 Enhanced
  115. mode are the same as in standard or real mode  except that it is
  116. incompatible with two of the Windows virtual device drivers.  WinBlank,
  117. WinTosh, and the Toshiba AutoResume driver are also incompatible with
  118. these drivers.  If you are using '386 Enhanced mode then you will need
  119. to edit the file "system.ini" in your main Windows directory.  You will
  120. need to insert a semicolon before the lines "device = *int13" and
  121. "device=*wdctrl" if they exist in the [386Enh] section of this file. 
  122. For Example:
  123.  
  124.  locate and change:
  125.      [386Enh]
  126.     ...
  127.     device = *int13
  128.     device = *wdctrl
  129. to:
  130.     [386Enh]
  131.     ...
  132.     ;device = *int13
  133.     ;device = *wdctrl
  134.  
  135. This will comment out the lines and prevent the int13 and wdctrl
  136. drivers from loading.  
  137.  
  138. ALSO AVAILABLE:
  139. I have also implemented the following utilities in an effort to bring
  140. all of the Toshiba's special features into the Windows 3.0 environment:
  141.  
  142. WinTosh:  (Available now for T2000SX, T2000SXe)  Toshiba control panel
  143. for Windows 3.0 which allows you to set all of the  special features of
  144. your Toshiba computer including Modem On/Off, Speaker On/Off, Battery
  145. Alarm On/Off, Hard disk power down time, Display power down time,
  146. Boot/Resume mode, Sleep mode On/Off, etc...  Currently works only with
  147. T2000SX and T2000SXe computers but will be expanded shortly to function
  148. with the entire line of Toshiba computers. $15.
  149.  
  150. WinBlank:  (Available now) A special Windows 3.0 screen blanker for
  151. Toshiba computers which will power down the display backlighting during
  152. periods of inactivity.  This differs significantly from the built in
  153. power down feature in that WinBlank understands mouse activity and
  154. allows the screen to power down even when connected to external power.
  155. $15.
  156.  
  157. WinChad:  (Yet to be completed)  VChad like program for Windows 3.0 to
  158. control the computer's display palette and to load and save palettes
  159. from disk.
  160.  
  161.  
  162. DISTRIBUTION:
  163. You may receive updated versions of this software from any of the following
  164. locations:
  165.  
  166. 1) The Toshiba America Computer Systems Division bulletin board at
  167.    1-714-837-4408
  168. 2) By mail to registered owners: $5 for updates (US addresses), or
  169.    $20 for new owners (includes license).
  170. 3) By Email free to registered owners who have access to the internet.
  171. 4) By anonymous FTP from cica.cica.indiana.edu in the pub/pc/win3/utils
  172.    directory (or possibly in the pub/pc/win3/misc directory).
  173.  
  174. LICENSING:
  175. You are authorized to use this software on a trial basis for a period
  176. of 30 days from the date that it is installed on your computer. 
  177. After that period you must purchase  a valid licensed version from me
  178. (F. Scott Porter) or you must remove WinBatt from your system.  You are
  179. free to distribute this program in its original zipped form with all of
  180. its files intact (WinBatt.Txt, WinBatt.Wri, WinBatt.exe, Readme.txt) as
  181. long as you charge no more than a reasonable copying fee.
  182.  
  183. All trademarked items mentioned in this text are trademarks of their 
  184. respective owners.
  185.  
  186. ADDRESSES:
  187. You may contact me by Email at ST402248@Brownvm.brown.edu or by mail
  188. at:
  189.           F. Scott Porter
  190.           Porter Gable Associates
  191.           143 Woodbine St.
  192.           Providence, RI 02906
  193.           (401)272-4255
  194.  
  195. ACKNOWLEDGEMENTS:
  196. I would like to thank Scott Reed of Toshiba America for his advice,
  197. helpful discussions, beta testing and the source code to his utility
  198. "BatStat1".  I would also like to thank Cheryl Blount of Toshiba
  199. America for allowing me to see the source code to her utility
  200. "ToshUtil".
  201.